claude prompt rehberi

Anthropic'in Claude modelleri için resmi prompt mühendisliği dokümantasyonu; XML etiketleri, sistem promptu, örnekle öğretme gibi Claude'a özgü teknikler. Claude'dan en iyi sonucu almak için okunması gereken sayfa.

platform.claude.com/docs/en/bu...

rehberin özünü tek entry'de toplamak gerekirse, anthropic'in kendi dokümanlarında tekrar tekrar söylediği şeyler şunlar:

1. net ve doğrudan yaz. modele "kısa özet" değil "en fazla üç cümle, her cümle bir bulgu" de. muğlak talimat muğlak çıktı getiriyor.

2. rol ve bağlam ver. sistem mesajında kim olduğunu ve kimin için çalıştığını anlat: "sen bir kobi muhasebecisine yardım eden asistansın, okuyucu vergi terimlerini bilmiyor". aynı soruya cevap belirgin değişiyor.

3. veriyi talimattan ayır. uzun bir belge, e-posta ya da kod veriyorsan xml etiketleri arasına koy; sonra talimatta o etiketi referans ver. model neyin girdi neyin komut olduğunu karıştırmıyor.

4. örnek göster. istediğin çıktı biçiminden iki üç örnek (few-shot) vermek, sayfalarca kural yazmaktan daha etkili.

5. düşünmesine izin ver. karmaşık işlerde "önce adım adım düşün, sonra cevabı yaz" demek doğruluğu artırıyor; düşünceyi ayrı bir bölümde isteyip son cevabı ayrı almak temiz çıktı sağlıyor.

6. uzun belgeyi üste koy, soruyu en alta yaz. uzun bağlamda talimatın sonda olması hatırlanmayı artırıyor.

7. "bilmiyorsan bilmiyorum de" cümlesini ekle. uydurma cevabı azaltan en ucuz yöntem.

8. çıktının başını sen yaz (prefill). cevabın json ile başlamasını istiyorsan asistan mesajını süslü parantezle başlatmak, açıklama cümlelerini ortadan kaldırıyor.

rehber ne değil: sihirli kelime listesi değil. "lütfen" yazmak ya da "sen bir dünya uzmanısın" diye şişirmek ölçülebilir fark yaratmıyor; işi iyi tarif etmek yaratıyor.

türkçe çalışanlar için somut bir şablon, günlük işte en çok işe yarayan biçim:

sistem mesajı: "sen, türkiye'de faaliyet gösteren küçük bir e-ticaret şirketinin müşteri destek asistanısın. yalnızca aşağıdaki politika belgesine dayanarak cevap ver. belgede olmayan bir konu sorulursa, bilmediğini söyle ve müşteriyi insan temsilciye yönlendir. üslup: samimi ama kısa, en fazla dört cümle."

kullanıcı mesajı: politika belgesi bir etiket içinde, müşteri sorusu ayrı bir etiket içinde, en altta talimat: "soruyu politika belgesine göre cevapla."

bu kadar. deneyimle öğrendiğim hatalar: (1) türkçe yazıp ingilizce cevap almak: sistem mesajında dili açıkça belirt, aksi halde girdideki ingilizce parçalar dili kaydırabiliyor. (2) "resmi ol" demek yetmiyor; "siz diye hitap et, emoji kullanma" gibi somutlaştır. (3) tek prompt'a beş iş yüklemek: özetle, çevir, sınıflandır, cevap yaz, etiketle. bunları ayrı çağrılara bölünce her biri daha iyi çıkıyor. (4) örnek vermeden biçim beklemek. tablo istiyorsan iki satırlık örnek tablo koy.

bir de değerlendirme alışkanlığı: prompt'u değiştirdiğinde eski 20 soruyu tekrar çalıştırıp karşılaştır. hissiyatla "daha iyi oldu" demek, üretim ortamında pahalıya patlıyor. yapay zeka başlığındaki eleştirel entry'ler bu konuda okumaya değer.

şüpheci not: 2023'te "prompt mühendisliği" diye bir meslek doğacağı söylendi, iş ilanları çıktı, kurslar satıldı. 2026'da gelinen nokta şu: modeller talimatı anlamakta o kadar iyileşti ki rehberlerin yarısı gereksizleşti. anthropic'in kendi rehberi de her sürümde kısalıyor; "nazikçe iste" gibi maddeler çoktan çıktı, kalan maddeler aslında iyi iletişim kuralları.

yani kalıcı beceri prompt yazmak değil, işi tanımlamak. hangi girdiden hangi çıktıyı beklediğini, neyin doğru sayılacağını, hangi hatanın kabul edilemez olduğunu yazabilen kişi, hangi modelle çalışırsa çalışsın iyi sonuç alıyor. yazamayan kişi en iyi modelle de kötü sonuç alıyor.

bu yüzden rehberi okumanın en iyi yolu, onu bir yazışma rehberi gibi okumak: yeni işe başlayan bir stajyere iş verirken ne yazardın? bağlam, örnek, sınırlar, kontrol yöntemi. aynı şeyi modele yazıyorsun. farkı, stajyerin bir süre sonra öğrenmesi; modelin her seferinde baştan anlatılması gerekiyor. bu da rehberin asıl işlevini gösteriyor: bir kez iyi yazılmış, tekrar kullanılabilir talimat kütüphanesi kurmak. sohbet penceresine her seferinde sıfırdan yazan kişi prompt mühendisi değil, unutkan kullanıcı.